.TH std::quick_exit 3 "2024.06.10" "http://cppreference.com" "C++ Standard Libary"
.SH NAME
std::quick_exit \- std::quick_exit

.SH Synopsis
   Defined in header <cstdlib>
   [[noreturn]] void quick_exit( int exit_code ) noexcept;  \fI(since C++11)\fP

   Causes normal program termination to occur without completely cleaning the
   resources.

   Functions passed to std::at_quick_exit are called in reverse order of their
   registration. If an exception tries to propagate out of any of the functions,
   std::terminate is called. After calling the registered functions, calls
   std::_Exit(exit_code).

   Functions passed to std::atexit are not called.

.SH Parameters

   exit_code - exit status of the program

.SH Return value

   \fI(none)\fP

.SH Example


// Run this code

 #include <cstdlib>
 #include <iostream>

 template<int N>
 void quick_exit_handler()
 {
     std::cout << "quick_exit handler #" << N << std::endl; // flush is intended
 }

 void at_exit_handler()
 {
     std::cout << "at_exit handler\\n";
 }

 int main()
 {
     if (std::at_quick_exit(quick_exit_handler<1>) ||
         std::at_quick_exit(quick_exit_handler<2>))
     {
         std::cerr << "Registration failed\\n";
         return EXIT_FAILURE;
     }

     std::atexit(at_exit_handler); // the handler will not be called

     struct R { ~R() { std::cout << "destructor\\n"; } } resource;

     /*...*/

     std::quick_exit(EXIT_SUCCESS);

     std::cout << "This statement is unreachable...\\n";
 }

.SH Output:

 quick_exit handler #2
 quick_exit handler #1

.SH See also

   abort         causes abnormal program termination (without cleaning up)
                 \fI(function)\fP
   exit          causes normal program termination with cleaning up
                 \fI(function)\fP
   atexit        registers a function to be called on std::exit() invocation
                 \fI(function)\fP
   at_quick_exit registers a function to be called on std::quick_exit invocation
   \fI(C++11)\fP       \fI(function)\fP
   C documentation for
   quick_exit
